Copyright: ZBSoft Corp. 1997


ZBServer Pro - Help Contents

ZBServer Pro is a World Wide Web (HTTP), Gopher and FTP server for personal computers running Microsoft (tm) Windows versions 95 or NT. It allows you to create your own site on the web.

If you keep using this program, please register it.  Please check at the following web site for more information:  http://www.zbserver.com

New features are constantly being added to this program.  Check at our website for a newer version.

Sellect the following for more help:

•	Introduction

•	What does ZBServer do?

•	Frequently Asked Questions

•	Menu Commands

•	Log Files

•	Tray Icon

•	Settings Screen (Property Pages)

•	Server Side Includes

Documentation and more information can be found on the following  web page: http://www.zbserver.com/

Thank you for using ZBServer Pro.


Introduction

Thanks for choosing ZBServer as your Web server choice.  We feel that you have made a good one, and better yet, you will too!  ZBServer, whether your product is the Personal or Professional Edition, is easy to configure, use and maintain.  ZBServer can help you be productive and innovative over your network whether you are at home, in your office or in

your business enterprise.

ZBServer provides you with many outstanding features integrated into one web server solution:

•	ZBServer is a proven server in use in over 28 countries.

•	ZBServer gives you fast and easy installation, configuration and maintenance.

•	ZBServer provides lightning fast transport for your HTML and other documents.

•	ZBServer allows free and password restricted accounts for not only your HTML documents but your entire hard drive.

•	ZBServer has a small memory footprint allowing it to run silently in the background without interfering with your daily work.

•	ZBServer also includes an integrated, easy-to-use gopher server with each copy.

•	ZBServer supports CGI, DOS scripts, and Microsoft Visual Basic applets as well as WinPerl and image mapping.

•	ZBServer supports many common "server-side" codes that can enhance your web site.

•	Full support for Windows 95, Windows NT and a variety of Windows 3.1 and 3.11 TCP/IP drivers (not included).

•	Server diagnostics help users keep track of network server load and network buffer handling.

•	ZBServer's control center helps you keep tabs on your server's performance at a glance.

•	ZBServer Pro edition can be run as a native service under Windows NT.

•	ZBServer Pro integrates HTTP, Gopher and FTP services into one easy-to-use program.

•	And much more ...

This guide should tell you all you need to know to setup and configure your copy of ZBServer.  For additional information resources, there are online documents to help you at a glance and extensive documentation at our web site at http://www.zbserver.com/.


What does ZBServer do?

ZBServer is an integrated Internet server for education, business and personal use.  It is fast, inexpensive and easy-to-install, configure and administer.  To use ZBServer, you must have a dedicated connection to the Internet in the form of a ethernet, common carrier link (56Kb, T1, other) or an ISDN connection.  Your local telephone carrier can give you more information on these dedicated and semi-dedicated connections.  After this, you can use ZBServer as your own web site open to visitors from around the world.

Server Applications

Web servers are everywhere!  Within the next few years, personal, business and corporate web pages will be as commonplace as electronic mail accounts are today.  With this technology, text, spreadsheets, graphics and animation are available to the world at the touch of a button.  Currently, UNIX computers dominate the Internet.  Costly and complex, these server systems require knowledge of UNIX and network protocols to install, operate and maintain.  ZBServer changes that for the prospective web server administrator!

ZBServer can be used in your home or business to share information with users on your local network, Internet users or just to get to your files at the office from home.  The limits to the uses for ZBServer are limitless:

·	Enterprise-wide information retrieval

·	Personal information publishing

·	Sales and advertising

·	On-line testing and "feedback" medium

·	File sharing and presentation

·	Local-area network file transfers

·	On-line company manuals and policy statements

·	File transfers from office to home

·	Chat server

·	And more....

The truth is that ZBServer is open for what your ideas are for the technology.  Surprise us!  Many have already surprised us with great innovations with ZBServer.  ZBServer is easy to use, flexible and inexpensive compared with most commercial Web server packages.  Whether it be corporate Web service to the worldwide Internet or a personal home-based Web site, ZBServer provides power, features and flexibility.


Frequently Asked Questions

Can my Windows-based computer run ZBServer?

Yes!  As long as your computer meets the minimum specifications below in the "System Requirement" section, your common Windows-based computer can run ZBServer.

What do I need to use ZBServer?

You will need a computer with the minimum specifications below in the "System Requirement" section, a network interface and software and a dedicated line to the Internet from your local Internet Service Provider (ISP).  The best place to find information on getting a local ISP is from your newspaper or a computer store in your area.

Can my Macintosh run ZBServer?

No.  ZBServer is for Microsoft Windows 3.1, 95 or NT computer only.

Can Macintosh computers access my ZBServer system(s)?

Yes.  As long as the Macintosh is using a standard HTTP browser (such as NetScape or Mosaic), it should be able to visit your ZBServer system.

How do I buy ZBServer?

Check out our web site at "http://www.zbserver.com/" and see the section entitled "Product Features, Pricing and Ordering".

Can I try ZBServer before I buy it?

Yes!  Each copy of ZBServer available at our web site is usable for a limited time.  If you like it, register it and keep it.  If you don"t like it, erase it from your hard drive and forget it!

Is there an educational discount for ZBServer?

Yes!  Check out our web site for pricing information.

Is there a quantity discount for ZBServer?

Quantity and distributor discounts are negotiated on a case-by-case basis.  Email "sales@zbserver.com" for a quote.

What is the meaning of life?

We aren"t positive but email our listserv and I"m sure you"ll get several good answers...


Menu Commands

Sellect the following for more help on ZBServer Pro's menus:

File Menu

Edit Menu

View Menu

Help Menu


File Menu

Cycle Log Files	Rotates the old log files and then creates new blank log files..

Pause the Server	Pause/Resume the server.  Keeps the server from accepting new connections.  New connection attempts will receive a user-defined message.

Hide	Causes the server to hide.  Use the Windows 95 tray icon menu to show it again.

Show

Exit	Stops the server and quits the program.


Cycle Log Files

Rotates and then creates new blank versions of  the following log files:

\zbs\logs\zbs.log

\zbs\logs\zbsp.log

\zbs\logs\error.log

\zbs\logs\referer.log

\zbs\logs\agent.log

The files are cycled in the following manner:

zbs.log -> zbs-001.log -> zbs-002.log -> ... -> zbs-030.log

The file zbs-030.log is erased and then zbs-029.log is renamed to zbs-030.log, zbs-028.log is renamed to zbs029.log all the way down to zbs.log is renamed to zbs-001.log and then a new blank zbs.log is created.


Pause The Server

Choosing the Pause The Server under the File menu brings up the following dialog box:

If you press OK on this screen, the server will pause.  When paused, the server will continue servicing any currently pending connections, but will display the message supplied to new web users.  (FTP and Gopher users will receive an error message telling them that the server is paused.)  To un-pause the server, choose Pause The Server again.


Edit Menu

Copy Screen Log	Copies the contents of the on-screen log into the clipboard.

Reset Screen Log	Clears the on-screen log.

Settings	Opens up the ZBServer property pages.

Users	Goes to the Trusted Users property page.

Shared Folders	Goes to the Shared Folders property page..


View Menu

Toolbar	Hides or shows the toolbar.

Hit Count Bar	Hides or shows the hit count toolbar at the top of the window.

Status Bar	Hides or shows the status bar at the bottom of the window.

HTTP Request Headers	Turns on or off the HTTP request header debugging information.  When turned on, the full HTTP request headers sent by the browsers will show up on the screen log.  Useful for debugging CGI programs.  Will slow the server down when turned on.

CGI Information	Turns on or off the CGI debugging information.  When turned on, additional information about CGI commands issued will show up on the screen log.   Useful for debugging CGI programs.

FTP Commands	Turns on or off the FTP commands debugging information.  When turned on, any FTP commands issued will show up on the screen log.

Connects	When turned on, the hostname or IP of the remote computer will be printed to the screen log as soon as it connects.

Commands	When turned on, the hostname or IP and the HTTP commands given by the remote computer will be displayed.

File Paths	When turned on, both the web paths and the real paths will be displayed for each file accessed.  Useful for debugging.

Closings	When turned on, a message will be displayed as each connections is closed.  Transfer rates will be shown for HTTP connections.

Current Open Connections	Causes a list of the current open connections to be printed on the screen log.  The list contains information about these connections including connection type, filename, bytes sent and file size.

Current DNS Cache	Causes a list of the current DNS (Hostname to IP numbers) cache to be printed and brings up the DNS Cache window.  Can be used to see the names of the last few computers that have accessed your site.  Also shows how long it has been since they accessed and how many connections they made.


Current Open Connections

The View:Current Open Connections menu causes a list of the current open connections to be printed on the screen log.  The list contains information about these connections including connection type, filename, bytes sent and file size.

Example output:

------- Socket Info --------

Type User     OtherHost        Object           Sent     Size

   3 gopher   192.239.148.29                            0         0

   1 anybody  192.239.148.29   /messages/bboard.htm

16382     26486

 Open Connections: 2

             Peak: 8

Total Connections: 2425

Fields:

Type -  1 HTTP, 2 FTP, 3 Gopher, 4 Test

User - The verified username for Web or FTP users.  If no real username was used, will be "anybody" for web users and "anonymous" for ftp users.

Otherhost - The IP address of the remote host.

Object - The filename or object requested.

Sent - The number of bytes sent so far.  May show up as 0 for CGI and other non file requests or if the server has not yet retrieved the file.

Size - The filesize of the object requested.  May show up as 0 for CGI and other non file requests or if the server has not yet retrieved the file..


Help Menu

Help Topics...	Lets you see the help file.

Registration...	Brings up the registration property page.

About ZBS_Pro...	Brings up the about screen which contains version information about the program.


Settings Screen (Property Pages)

General

Logging

Hit Counts

Misc

Users

File Types

Shared Folders

CGI

Registration

Servers


General Settings

Webmaster

This section contains information about the "webmaster" who is the person responsible for this server.

Name:  The name of whoever will be the "Webmaster" for the server.

Organization:  The name of the organization responsible for the server.

E-Mail:  The webmaster's full e-mail address.

This Computer's

This section contains information about your computer.  You may need to get this information from your network administrator or Internet Service Provider.  If you leave these fields blank, ZBServer will try to run using default settings, but it may not work correctly.

DNS Host Name:  The full internet name of your computer including the domain name.  Example: yourhost.yoursite.com

Host IP:  The unique internet IP number assigned to your computer.  Example: 192.239.148.29


Logging

The ZBServer Logging setup screen allows you to turn on or off ZBServer's logging features.  For more information about logging, see the Log Files section.

Log to Extended Log File (zbsp.log)

Turns on or off logging to the extended log file.

Include Server Field

Includes a key called server in each extended log entry that indicates which server (web, gopher or ftp) made the entry.

Include Referer Field

Includes the referer information  in each extended log entry.

Include User Agent Field

Includes the User Agent field (browser type information) in each extended log entry.

Log to Multiple Log Files

Turns on or off the following log files.

Access Log (zbs.log)

Turns on or off the Access Log file.

Referer Log (referer.log)

Turns on or off the Referer log file.

User Agent Log (agent.log)

Turns on or off the User Agent log file.

Error Log (error.log)

Turns on or off the Error log file.

Log File Directory Field

This field should contain the DOS path to the directory where you want your log files stored.


Hit Counts

ZBServer can automatically keep track of how many times each page on your server has been looked at.  This allows you to use the $hit_count macro to put a hit count on a page.  The Hit Counts screen allows you to control this feature.

Hit counts can either be stored in the COUNTS.ZBS file (in the logging directory) or in a subdirectory's local access  file (ACCESS.ZAC).  Each directory can contain a local access file which can contain a [COUNTS] section.  If hits are allowed in the access file, they will override hit counts in the COUNTS.ZBS file.

Note, the COUNTS.ZBS file is currently limited to 64K.  If the file gets larger than that, hit counts may no longer work.  If your COUNTS.ZBS file gets big, either store some of the counts in an ACCESS.ZAC file and/or turn off the "Automatically add new files" feature.

Automatically keep track of the file hits in the COUNTS.ZBS file

Turns on or off the counts file.

Automatically add new files to the COUNTS.ZBS file

Turn this on to get your hit counts started, but turn it off when your counts file starts getting big (>64K)

Allow hit counts in local access files (ACCESS.ZAC)

Turn this on to allow hit counts to be (also) stored in ACCESS.ZAC files.


Misc

The Misc Setup dialog allows the user to set some specific options for the server.  These options are:

Temp Directory:  The DOS path for the temporary file directory.  Cache and other system information will be temporarily stored in this directory when necessary.

Security Realm:  The name of the Security Realm for this server.  Set it to be the same as your hostname unless you maintain several servers with common usernames and passwords.  If you set multiple servers to have the same Security Realm, browsers will try to use the same usernames and passwords for each server with the common realm.  This can save your users from having to retype their username and password, when they are hopping between your servers.

Do Reverse DNS Lookups:  When taking incoming user requests, ZBServer will identify and log users by looking up their Domain Name Service (DNS) host name.  This will give you a more precise view of who is hitting your site. However, if you have a slow DNS name server, this can slow your ZBServer down.   If DNS mode is turned off, the server will use the IP number of the remote host.

Cache DNS Hits:  Speeds up DNS lookups by caching the last few looked up hostnames.

Start as 95 Service:  Adds an entry to the Windows 95 registry so that ZBServer will startup automatically before the normal login screens.

Minimize after start:  ZBServer will minimize after starting up.

Hide after start:  ZBServer will hide after starting up.  Use the tray icon to access ZBServer if it is hidden.

Ask before quiting:  ZBServer will prompt you before quitting so that you don't accidently quit it.

Beep on POSTs:  ZBServer will beep whenever it get's a POST command such as when a message is posted to the message board or when CGI programs are run.

Send Buffer Size:  How much data ZBServer sends at one time.

Read Timeouts:  How long (in seconds) before ZBServer closes a connection.


Users

ZBServer Users and Groups Setup

Setting Up Users

ZBServer will allow the Webmaster to setup general places on the web server where anyone can get information.  Additionally, the Webmaster can set up privileged users and groups.  This is done through the use of usernames and passwords.  When you first install ZBServer, you will find that your "C:\zbs\html", "C:\ZBS\GOPHER", "C:\ZBS\MESSAGES" and "C:\ZBS\CGI" subdirectories will automatically be accessible to all web users.  General web users should also be automatically restricted to just the default subdirectories mentioned above.

To add a privileged user, simply click the "New User" button.  Add the username in the field and click the "OK" button in the dialog box you see below.  Usernames should be 8 characters or less, are not case sensitive and should not contain spaces or other specials characters.

New User Button

Adds a new user to your user list.  Brings up the New User screen, followed by the Change Password screen and then the FTP User Options screen.

Change Password Button

Changes the password of the selected user.  Brings up the Change Password screen.

FTP Options Button

Changes the FTP options of the selected user.  Brings up the FTP User Options screen.

Groups Button

Allows you to add/remove a user to/from groups of users.  Brings up the User Groups screen.

Remove User Button

Removes the user from your list of users.  Brings up the Delete User screen which asks if you are sure.


New User Screen

This screen allows you to type in the name of a new user.  The username can be up to 8 characters and is not case sensitive.  The username should not contain spaces or other "funny" characters.


Change Password Screen

The Change Password screen allows you to change a user's password.  Passwords can be 8 characters or less, are CASE sensitive and should not contain spaces or other "funny" characters.

Type the password in the first box, hit the <TAB> key to get to the second box and then type in the same password again.  This will verify that you typed the initial password correctly.  You will find that both passwords you type will be entered as asterisks to hide the characters you are entering from "curious eyes."


FTP User Options Screen

User can FTP

Check to allow user to log into FTP server.

Home Directory Field

Defines the selected user's FTP home directory.  When the user logs in with FTP, they will automatically be taken to this directory.  Use the popup button to the right of this field to select a URL.

User can write to Home Directory

If checked, user can upload, rename and delete files and folders in their home directory.

Restrict to Home Directory Checkbox

If "Restrict to Home Directory" is checked, the selected user's home directory (see above) will be their root path "/" and they will be restricted to only this URL and its children.  If this box is not checked, the user's root path "/" will be the default ftp home directory and the user will also be able to CD (change) to other public URL paths on your system.

FTP Super User Checkbox

This option (if checked) will make the selected user a "Super-User" (sounds powerful, huh).  The user will be able to go anywhere and edit, create or delete anything on the system.


User Groups Screen

The User Groups screen allows you to add a user to a group or other users or remove them from a group.

The list on the left is the list of groups that the user is currently a member of.  The list on the right is the list of all groups currently defined.

The "<--" button will move a group into the list of groups that the user belongs to.  It will add a user to that group.

Use the "-->" button to remove a user from a group.

Use the "New" button to create a new group.


File Types

This dialog allows users to set or adjust the MIME (Multipurpose Internet Mail Extensions" types for the server.  MIME types tell  internet browsers how to process a file (ASCII text, binary, etc.).  These extensions are matched to different types of applications or given basic characteristics (such as text) in order to tell the browser how to process the information or to tell it how it is to be viewed or downloaded.

File Listbox:  The file listbox contains all of your defined file types.  Click on a line to edit it.

Extension:  The filename extension to match (EXE, HTM, etc.).

Gopher:  The gopher type to map this type of file to.

MIME:  The MIME type to match this file to.

Icon URL:  A URL (web path) to a small image to display for this type of file in a directory listing.  The server will use this when it creates a directory index.

New Mapping Button:  Press this to add a new file type such as .PDF, to the list.

Delete Mapping:  Press this to remove the selected file type from the list.


Shared Folders

The ZBServer Shared Folders screen allows you to share and restrict access to any folder on any drive (local or remote) mounted on your computer.  You can also use this dialog to set more detailed levels of permissions for your users and groups.

The Path Listbox at the top of the screen shows all folders that ZBServer is setup to share.  Click on a line to edit it.  Each line shows the URL Path, DOS Path, Owner field, Access field and the Allows fields.  The Allows fields are abbreviated as C for Allow CGI, M for Allow Messages and D for Allow DIR.  See below for the meaning of each field.

The URL Path is the path that remote users will use to access your files.  This field should use standard web paths with forward slashes (/).

The DOS Path is the actual location of the directory.  Remote users do not use the DOS Path, they use the URL Path.  Use the browse button (...) to the right of this field to select a new directory. This field should use DOS pathnames with back slashes (\).

The Owner Field allows you to restrict a URL Path to a certain user or group of users.  The default for this field is "Anybody" which allows any browser to get to this URL without a name or password.

The Access Field allows you to restrict a URL Path to your local subnet.  The default for this field is "Anywhere" which allows any host to get to this URL.  If you want to restrict this URL to local access only, then set this field to be your correct subnet type (Class A, B or C).  Check with your network person or Internet Service Provider for more information.

The Allow CGI Checkbox turns on or off CGI mode for the selected path.  Turn on CGI mode to allow users to execute CGI scripts in this subdirectory.  CGI (Common Gateway Interface) scripts can do specific server functions such as searching a database.  If CGI mode is on, the server will actually run (instead of send) .BAT, .EXE and .PL files when they are requested and then send back the CGI output.  If CGI mode is off those files will be sent as either text or binary files.

The WinCGI and StdCGI buttons are used to set the CGI mode for the directory.  If WinCGI is clicked, scripts are run using the WinCGI file-passing standard.  If StdCGI is checked, scrpts are run using the Standard CGI (stdin/stdout) method.

The Messages Checkbox allows users to post information to message boards in this subdirectory.

The DIR Checkbox allows users to get a listing of the contents of one of the subdirectories (instead of or in addition to getting the "index.htm" page).  If DIR mode is turned off, users will receive an error message when they request one of the subdirectories (/thispath/) unless one of the following files is in the directory: index.htm, zbheader.txt or zbheader.htm.

The Add Folder Button allows you to add a new shared folder to your list.

The Remove Folder Button allows you to remove a shared folder from your list.


CGI

Use the CGI setup screen to set CGI options and to include the path of your Perl Interpreter and the directory of your Perl library files.

Enter the DOS path to your Perl Interpreter into the Perl Compiler field.  Example: C:\PERL\PERL.EXE

Enter the DOS path to your Perl library directory into the Perl Directory field.  Example: C:\PERL

Use the CGI Debug Mode switch to turn on and off CGI Debug Mode.  When on, ZBServer will keep old copies of the CGI and Perl input, content and output files.  It will also send the CGI Debug message to CGI programs.  This is useful when you are programming your own scripts or trying to get new CGI scripts to run.

GMT Offset - This field is sent to CGI programs which may or may not user it.  It is the number of seconds to be added to GMT time to reach local time.  For pacific Standard time, this number is -28,8000.  Useful for computing GMT times.


Registration

Click the Register button to enter or edit your ZBServer Pro registration name and code.

For more information on how to register this program, see the web page http://www.zbserver.com/  or send email to  sales@zbserver.com


Servers

This screen is used to set the default directories, ports and other options for the web, gopher and FTP servers.

Windows NT users can use this screen to add multiple servers listening on multiple IP's and hostnames.  Windows 95 users are limited to only one IP number but can create multiple servers listening on multiple ports.

More information is on our web page at:

http://www.zbserver.com


Log Files

Logging helps you keep track of which pages are being looked at and gives you information about where your visitors are coming from. It can also give additional information such as what types of browsers your users are using, which pages have links to your pages and which pages have bad links on them.

ZBServer Pro has several logging options.  It can log to multiple log files (NCSA Common Format access, error, referer and agent) and/or it can log all information to a single Extended Format log file.

ZBServer can write to several different files.  However, turning on all of the logging options can cause the server to log more information than you really need, can slow down the server and can fill up your disk space really fast.  It is redundant to turn on both the Extended log and the Access Log.

The following list describes each type of log file that ZBServer can write to:

Access Log (zbs.log)

Extended Log (zbsp.log)

Error Log (error.log)

Referer Log (referer.log)

Agent Log (agent.log)

When the log files start getting big, you can use the Cycle Log Files menu to copy them to backups and create new blank long files.


Access Log (zbs.log)

NCSA Common Log Format Access Log

The Access Log (zbs.log), if turned on, records all accesses made to your server.  The log is in NCSA Common Log format and because this is a format used by many servers, there are many tools out there to analyize your log files.

Sample Log file entries:

bbgun.at.utm.edu - - [02/Apr/1996:18:12:15 -0700] "GET / HTTP/1.0" 200 2585

bbgun.at.utm.edu - - [02/Apr/1996:18:12:15 -0700] "GET /cgi/clock101/clock.exe HTTP/1.0" - 0

bbgun.at.utm.edu - - [02/Apr/1996:18:12:16 -0700] "GET /gifs/mailto.gif HTTP/1.0" 200 788

bbgun.at.utm.edu - - [02/Apr/1996:18:12:15 -0700] "GET /gifs/commentS.gif HTTP/1.0" 200 514

Format:

Each entry in the log consists of the following fields separated by blank spaces.  There is one entry per line.

Field Name	Format and/or Example

Hostname or IP	bbgun.at.utm.edu

192.239.148.29

Not Used	-

Username	bbradley

Date 	[day/Month/Year:Hour:Min:Sec Offset]

[02/Apr/1996:18:12:15 -0700]

Command	"Command URL HTTP"

"GET / HTTP/1.0"

Status	200

Bytes Sent	788


Extended Log (zbsp.log)

The Extended Log records all accesses made to your server and can also record error, referer and agent information all in one file.

Sample Log file entries:

log {start 828984390} {method GET} {server web} {url /} {bytes 2380} {host BOB-BRADLEY2.utm.edu} {end 828984394}

log {start 828984397} {method GET} {server web} {url /gifs/commentS.gif} {bytes 514} {host BOB-BRADLEY2.utm.edu} {end 828984397}

log {start 828984396} {method GET} {server web} {url /gifs/bobb6.gif} {bytes 15940} {host BOB-BRADLEY2.utm.edu} {end 828984398}

Format:

Each entry in the log starts with the word "log" and is followed by several keys.  Each key is surrounded by braces "{}" and contains both a field name and data.  Each key is separated by spaces.  There is one entry per line.

The following keys are supported:

method	= HEAD, GET, POST

url        	object requested /whatever.htm

agent	NCSA ...

referrer	refering document (see Referer Information  for more information)

host	name or ip

error	error message

status	status of request

bytes	bytes sent

start      	fractional secs since Jan 1, 1970

end	fractional secs since Jan 1, 1970

server	web, gopher, ftp


Error Log (error.log)

The Error Log records errors encountered by the server.  The most common error recorded is "Not found."

Sample Log file entries:

Not found (/rainboy.gif)  Referer ( http://192.239.148.29/test.htm)

Not found (/gopser.gif)  Referer ( http://bbgun.at.utm.edu/zbsini.htm)

Format:

Each entry in the log consists of an error message and may be followed by a  filename and referer.  The filename is the name of the file that was requested when the error occurred.  The referer  is the name of the page that pointed to the file that caused the error.  There is one error entry per line.


Referer Log (referer.log)

The Referer Log records URLs (pages) that have pointers to your pages.  Referer information is passed by most (but not all) browsers.

Sample Log file entries:

http://www.zbserver.com/ --> /docs/

http://bbgun.at.utm.edu/docs/ --> /gifs/smspace.gif

http://bbgun.at.utm.edu/docs/ --> /gifs/new.gif

Format:

Each entry in the log consists of the refering URL followed by "-->" followed by the document requested.  So the first file "points" to the second file. There is one entry per line.


Agent Log (agent.log)

The Agent Log records information about the browsers that visit your pages.  Agent information is passed by most (but not all) browsers to the server when a request is made.  You can use this file to help you decide which browsers to tailor your pages to..

Sample Log file entries:

IBM WebExplorer /v1.0  via proxy gateway  CERN-HTTPD/3.0 libwww/2.17

Mozilla/2.0Ib6a [ja] (Win95; I)

Mozilla/1.22 (compatible; MSIE 2.0; Windows 95)

Format:

Each entry in the log consists of vendor information about the browser used. There is one entry per line.


Referer Information

The Referer information gives you the URLs (pages) that have pointers to your pages.  Each time a web request is made, referer information is passed by most (but not all) browsers to the server.  The referer information tells which page the user clicked on to get to the requested document.  You can use this information to help you find pages that point to your pages.   It also allows obsolete or mistyped links to be traced for maintenance.

You can log referer information in either the extended log or in the referer log.

You also use the $referer macro to display the referer information on a page.  This can be used for a "Return to XXXXX page" line.


Tray Icon

ZBServer Pro adds a small [image] icon to the Windows 95 task bar icon tray.

  Clicking on the icon will reveal a popup menu.

You can use this menu to show or hide the server, see version information about the server or to quit the server.

A black icon indicates that the server has no open connections.

When the server has open connections, the icon will turn red.

If you need to shut down your server, but you want to let the current open connections and  file transfers finish, you can use pause the server under the File menu.


MIME Types

Check under your browser for a list of MIME types and their extentions.


Gopher Types

0	text

1	directory

4 	mac-binhex

5 	binary

6 	UUEncoded

8 	Telnet

g 	image/gif

I 	image/jpeg

s 	audio

; 	video

h 	text/html


Server Side Includes

ZBServer Pro and Server Side Includes

Server side includes allow you to embed the output of CGI commands inside of a standard html document. Server side includes are embedded into your html document as html comments. Each line of a server side include must start (and end) with the standard html comment code followed by a pound sign like this:

<!--#SERVER SIDE COMMAND  -->

NOTE: With the current version of ZBServer Pro, the server side include lines must be at the start of a line.

New features are constantly being added to this program.  Check at our website for a newer version.

ZBServer Pro currently supports the following server side includes directives:

exec cgi="DOS PATH TO WIN CGI SCRIPT"

Inserts the output of the requested win cgi script into your document. The following example will insert the output of get4tune.bat (a random saying generator) into the page:

<!--#exec cgi="d:\zbs\cgi\get4tune.bat"-->

exec cmd="DOS PATH TO STANDARD PROGRAM"

NOTE: This tag may not work under NT. Inserts the output of the requested standard dos or windows program into your document. The following example will use the windows traceroute program to print the path between your machine and the client's machine (and stick the output in a list):

<!--#config cmdprefix="<li>" -->

<listing><ul>

<!--#exec cmd="c:\windows\tracert.exe $remote_address"-->

</ul></listing>

config cmdprefix="PATTERN"

Inserts the PATTERN before each line of output from following scripts. The following example will cause each line of output from a script to appear as a new entry in a list by inserting the html list code:

<!--#config cmdprefix="<li>" -->

config cmdpostfix="PATTERN"

Appends the PATTERN after each line of output from following scripts. The following example will cause each line of output form a script to have a paragraph marker placed after it:

<!--#config cmdprefix="<p>" -->

Example:

Here is a final example that gives your fortune:

<!--#config cmdprefix="<td> " -->

<table border width="90%">

<tr><th>Your fortune

<tr>

<!--#exec cgi="d:\zbs\cgi\get4tune.bat"-->

</table>

Your fortune

Fortune - Look after the molehills and the mountains will take care of themselves.